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INTRO ID TACTION 



OVERVIEW 



PLAYER MAKER is a BASIC utility program which makes it easy to use Atari's 
powerful animation feature called Player-Missile Graphics. PLAYER MAKER allows 
you to define the shape of each of your players and to view your players in different 
resolutions, widths, and colors* You can independently create up to four different 
players, but can work on constructing two players on the screen at any onetime 
enabling you to make comparisons. 

PLAYER MAKER generates a BASIC subroutine which you enter into your own 
program. You do not need any knowledge of the workings of Atari's Player-Missile 
Graphics capabilities or memory requirements to successfully utilize the power of this 
program. The design and implementation of the players and the necessary hooks for 
your program to put them on the screen and move them is totally handled by PLAYER 
MAKER. 



REQUIRED ACCESSORIES OPTIONAL ACCESSORIES 



ATARI BASIC Language Cartridge One ATARI Joystick Controller 

48K RAM 

ATARI 810 Disk Drive 



CONTACTING THE AUTHOR 



Users wishing to contact the author about PLAYER MAKER may write to? 

• 

Wayne Harvey 
ATARI Special Projects 
1196 Borregas Ave. 
PO Box 427 

Sunnyvale, CA. 94086 
or call him at: 



(408) 745-4991 



GETTING STARTED 



LOADING PLAYER MAKER INTO MEMORY 

it Be sure a BASIC Language Cartridge is in the left cartridge slot of your computer 
console and that you have 48K or RAM* 

2. Have your computer turned off* 

3* Turn on your disk drive* 

4* When the busy light goes out. open the disk drive door and insert the PLAYER 
MAKER diskette with the label in the lower right-hand corner nearest you* (Use disk 
drive one if you have more than one drive*) 

5. Turn on your computer and your TV set. The program will load into computer 
memory and start automatically. 

6. It is advisable to remove the PLAYER MAKER master diskette once it is loaded 
and insert into your disk drive a blank formatted diskette for storing the subroutine 
created by this program* 



THE FIRST DISPLAY SCREEN 

If you properly loaded PLAYER MAKER, you will see: 

T T 

i i 

i i 

I <c> 1983 | 

I I 

| WAYNE HARVEY | 

I I 

I I 
I PLEASE WAIT A MOMENT | 

After a minute, a menu will appear at the top of your screen* The area in which you 
define your players will appear below this (see THE PLAYER MAKER SCREEN). 




USING PLAYER MAKER 

USING THE JOYSTICK OR THE KEYBOARD 

• 

Much of the use of PLAYER MAKER involves moving around a flashing cursor on the 
screen. At times you move the cursor within the menu which is located in the upper 
portion of the screen. At other times you move the cursor within a block eight units 
wide which is your player definition area. In either case, you have a choice of one of 
two methods to move the cursor — either you can use a joystick or the four arrow keys 
on the keyboard. 

Once you have positioned the cursor on a menu item that interests you, you have a 
choice once again of using either of two methods to tell PLAYER MAKER that you wish 
to select that item. You can either press the joystick button or you can hit the space 
bar on the keyboard. You also have the choice of using the joystick button or the 
space bar to switch on or switch off pixels when defining your player. 

For the purpose of discussion throughout this document, I will assume you are using a 
joystick and therefore I will refer to moving the stick left, right, up, or down. I also 
will refer to pressing the joystick button. If you choose not to use a joystick, then 
use the keyboard arrow keys in place of the stick and press the space bar instead of 
pressing the joystick button. 



THE PLAYER MAKER SCREEN 



| DEFINE PLAYER 

| RESOLUTION: single 

I PLAYER 0 

| START OVER 

j MODE solid 

| WIDTH 1 

I HUE 12 

I LUM 6 
I 

I I I 

I I I 

I I I 

i i i T~~T T~~T 

ii ill ii 
i i i j — l J — l 

i i i 

i , 1 

i 

I MESSAGES? Type F when finished. 



I 
I 

PLAYER 1 | 
START OVER | 
MODE solidl 
WIDTH 1 | 
HUE 2 | 
LUM 8 | 

I 

I I I 

I I I 

I I I 

I I I 

I I I 

I I I 

I I I 

I I I 

I I I 

I 1 | 
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Most of the time you are using PLAYER MAKER, your screen looks similar to how it 
appears in the illustration above* The first eight lines of the screen constitute the 
menu area. The next portion of the screen constitutes the player definition area* 
Messages are printed in the last two lines* The screen always has a left half and a 
right half* Each half contains information corresponding to a different player* 



THE PLAYER MAKER MENU 

The PLAYER MAKER program begins with a flashing cursor at the top of the menu 
area* If you select the first menu item ( DEFINE PLAYER ) by pressing the joystick 
button while the cursor is flashing on that item* you leave the menu and enter the 
player definition area (see DEFINING A PLAYER)* You also can accomplish this by 
typing a D on the keyboard* 

The second menu item ( RESOLUTION ) cannot be set individually for each player* The 
Atari Player-Missile Graphics feature requires that all players be the same 
resolution* To change the resolution of your players (from single to double or vice 
versa), position the cursor on RESOLUTION and press the joystick button* The change 
appears instantly on the screen* Double resolution players are twice as tall vertically 
as single resolution players* 



The cursor can be moved to the left or right side of the screen in order to alter items 
corresponding to the player on either side of the screen* Each half of the screen has 
six menu items that are described below* 

P LAYER ? Each half of the screen is used to define a particular player* This menu 
item shows the player's number which can be a 0, 1,2, or 3* Press the joystick button 
while the cursor is positioned on PLAYER to retrieve the player you wish to work on* 
All current information corresponding to the new player automatically appears on the 
screen* Each time you press the button, the player on that half of the screen changes* 
Since the player on the other side of the screen will not be duplicated, pressing the 
button three times will bring you back to the first player displayed* 

START OVER * Use this command cautiously* When the button is pressed, the player 
that appears below is reinitialized to a clean slate on which you can redefine that 
player* Thus, if you do not like the design of any given player, you can start over with 
this command* Before your player is destroyed, PLAYER MAKER asks (in the message 
window) if you are sure you want to reconstruct this player* If you wish to clear the 
player then type Y for YES. (See MODE)* 

MODEJ A player image is created by either illuminating or turning off pixels of light 
(little blocks of light) to make an object of a desired shape* For some images it is 
easiest to create the player by starting with a blank background and turning on some 
blocks of light* This mode of operation is called the "dear" mode* In most cases, 
however, it is easier to start with a block of light and turn off certain squares, 
leaving the desired shape behind* To use this technique, select the "solid" mode. By 
default, all players begin in the "solid" mode as a rectangular block of light 8 pixels 



wide and 10 pixels tall* If you wish to start with a blank slate, change the mode to 
-dear" (using the joystick button) and then select the START OVER command* The 
mode can be changed at any time without affecting any work you have done on your 
player. However, as you extend your player in the vertical direction, while in the 
solid mode, you will gain solid rows of light} if you are in the clear mode, your added 
rows will be blank. (See DEFINING A PLAYER). 

WIDTH ? The width of each player can be changed at any time. You always have only 8 
blocks of light (pixels) spanning the width of any player, but these pixels can be made 
thinner or wider. There are three possible widths? the default of 1, double width (2), 
and quadruple width (4). Position the cursor on WIDTH and press the joystick button, 
and the width will change from 1 to 2 to 4 and back to 1. 

HUE : The hue (color) of your player is changed by pressing the joystick button. Hues 
range from 0 to 15. If you press the button while a player's hue is 15, it changes back 
to 0. 

LUMJ The luminance (brightness) of your player can be increased in increments of two 
from 0 to 14 and back to 0 by pressing the joystick button. 

NOTE? The different colors of the players may be more or less pleasing depending on 
the color of the background. You can change the background color in the FINISHING 
UP mode (see page 6). 

DEFINING A PLAYER 



A player cannot be more than 8 units wide, but it can span up to the entire height of 
the screen. You are provided with a window 8 units wide which corresponds to an 
enlarged segment of the player. The actual player appears to the side of the window. 
Using the joystick you can move a cursor within this window, and by pressing the 
joystick button you can either illuminate or turn off blocks of light in the window. The 
corresponding pixel of light on your actual player is then simultaneously turned on or 
off. 

The window always remains 10 units high, but a player can grow vertically from its 
starting height of 10 units. Press the cursor against the top of the window to make a 
player taller. If you are in solid mode, you will see a solid line of light added to the 
top of the player. In clear mode, empty space is added to the top of your player. Your 
window will not stretch, but what you see in the window will scroll upwards. At any 
one time you will always see 10 rows of the player in the window, but by pressing the 
cursor against the window top or bottom, you can scroll the 10 rows you see in the 
window up or down. 

The window will no longer scroll up (or down) when your player's top (or bottom) has 
reached its limit. These limits are above the top and below the bottom of the screen. 

You can jump back and forth between defining the player on the left and right half of 
your screen by moving your cursor past the right or left edge of each corresponding 
window. At any time you can move the cursor into the Menu Area by typing the letter 
M on the keyboard. You can move it back to the Player Definition Area by typing the 
letter D on the keyboard. 
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Once you have defined all the players you wish to create* type F on the keyboard* All 
the players you have defined, and their corresponding widths, hues, and luminances, 
will appear on one screen* By placing the cursor on any of these menu items, you can 
make any final changes you wish in these attributes* If you are still not satisfied 
with the shape of a player, you can return to the Define Player mode* You also have 
the option of changing the color of the background* Once you have set the background 
to a new color, it will remain that color even if you return to the Define Player mode. 
You may also choose to save the =work you did and end the program* If you choose to 
end, you can request PLAYER MAKER to print an entire subroutine to disk (which 
makes it easy to use your players in a BASIC program)* If you wish to incorporate 
your player data into memory with your own routines, you may have only DATA 
statements printed to disk (these are included in the subroutine)* 



AMPLE APPLICATIONS 
HOW TO MOVE YOUR PLAYERS 



It is a simple matter to integrate the subroutine generated by PLAYER MAKER into 
your own program* You communicate with the PLAYER MAKER subroutine through four 
special variables? PLAYER. XSPOT, YSPOT, and MYPLAYER. Your BASIC program 
should assign values to PLAYER, XSPOT, and YSPOT, and follow this with the 
statement "GOSUB MYPLAYER"* Examples and explanations of how you accomplish 
this are shown in the demonstration program that follows* 

The value in variable PLAYER (0, 1, 2, or 3) tells the subroutine which of your players 
you want to move* All players originally are placed off the visible screen* By 
assigning a value to XSPOT and a value to YSPOT and then calling the subroutine 
MYPLAYER, you can move your player to the corresponding location on the screen* A 
value of zero in XSPOT corresponds to the leftmost edge of the screen while a value 
of 160 is the rightmost edge. YSPOT ranges from zero at the screen top to 100 at the 
screen bottom for double resolution players and 200 at the bottom for single 
resolution players. 

A player is positioned at (XSPOT, YSPOT) by placing its upper leftmost corner at the 
corresponding screen location. Thus putting a player at (0, 0) places its entire image 
on the upper leftmost corner of the screen while putting it at (160, 200) places all but 
the player's corner off the bottom and right edge of the screen* For this reason one 
will often want to begin by placing a player at say (-20, 0) where it would be just off 
the screen's left edge. By increasing XSPOT (and calling the MYPLAYER subroutine), 
the player appears to slowly move onto the screen* 

Avoid using variable names which begin with XX in your BASIC program since such 
names are used by the subroutine* Also, do not use line number 1 or line numbers 
above 30500* Once you have typed in your program (or retrieved it using the LOAD 
command), you must merge the PLAYER MAKER subroutine to it* To do this, type the 
direct command (no line number) ENTER "DJfilename" where "filename" is the file in 
which you told PLAYER MAKER to store your subroutine* You can now resave your 
entire program including the subroutine by typing SAVE "DJfilename"* Then, at a later 
date, you can load the entire program into memory with only one LOAD command* 

The following is an example, with explanations, of a program which uses two players* 
This program, along with the subroutine generated by PLAYER MAKER, is stored in a 
file called DEMO* To see it run, type! RUN "DltDEMO"* 
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110 REM PLAYER MAKER Deno program* 
112 REM By W3yne Harvey 
114 REM (c) 1983 
116 REM 

120 DIM X<1)*Y<1>*ANS*<1> 
130 REM 

132 REM Put Player 0 to left of screen and Player 1 to right* 
134 REM 

14 0 REM *x******x********^ 
142 POKE 53248, OtPOKE 53249,250 
144 REM ****tt**tt*x*x*****^ 
146 REM 

150 REM Turn screen black and turn off cursor* 

152 REM Reset color of Player 0 since program changes it* 

154 REM Reset collision registers* 

156 REM 

160 REM xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
162 GRAPHICS Q*P0KE 710,0tPQKE 752*1JPRINT 11 
164 POKE 704*19S:POKE 53278,0 

166 REM xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
168 REM 

170 REM Randomly select both X and Y coordinates for both players* 
172 REM 

^ Q p| |~! yti 5(C JtC 5(C 5(C )(C 5IC 5IC 5IC 5IC 5IC 5K 5(C )IC 5IC )(C )IC 5IC 5K 5(C )IC 3(C 5IC 5IC JIC 5IC )IC 5IC 5IC 3(C 5iC JIC 5(C 5IC 5IC 3(C 5IC 5IC 5(C 5IC )iC )(C JIC 5(C 5IC 3K 5IC 5IC 5(C )iC 5IC 

182 FOR PLAYER=0 TO 1 
184 X<PLAYER)=20+INT<110xRND<0> ) 
186 Y<PLAYER)=10+INT<70xRND<0> > 
188 NEXT PLAYER 

190 REM xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
192 REM 

200 REM Change the X and Y coordinates of both ( p layers . 
202 REM 

21 0 REM xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

212 XDIR=SGN(X(0)-X(1) > J YDIR=SGN ( Y ( 0 ) -Y < 1 ) ) 

214 X < 0 ) =X ( 0 ) +XDIR t Y < 0 ) =Y < 0 ) +YDIR 

216 IF X(0)>130 THEN X<0)=129 

218 IF X(0)<20 THEN X(0)=21 

220 IF Y<0)>80 THEN Y<0>=79 

222 IF Y(0)<10 THEN Y(0)=11 

224 X(l)=X(l)+INT<4xRND<0) )XXDIR:Y<1 )=Y(1 )+INT<4xRND<0) )xYDIR 

226 REM xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

228 REM 

230 REM The following two lines are the key to using MYPLAYER ♦ 

232 REM In each line the variables XSPOT , YSPOT , and PLAYER 

234 REM are assigned values, and then the MYPLAYER 

236 REM subroutine is called. 

238 REM 

24 0 REM xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

242 xspot=x<o) :yspot=y<o> :player=o:gosub MYPLAYER 
244 xspot=x(d :yspot=y<d :player=i :gosub MYPLAYER 

W g^ ^\ p| \^ 5(C 5IC )K 5(C 5(C 5(C 5iC 5(C )(C JIC 5(C )K 5IC 5(C 5IC 5IC 5(C 5fC 5(C 5IC )IC JIC 5(C 5IC )K )K J(C 5IC 5(C 5IC 5(C )IC 5(C 5(C 5IC )IC )IC )IC 5IC 5IC 5(C 5IC 5IC 3(C 5(C 5(C 5IC )IC 5(( J(C 5(C 

248 REM 
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250 REM The next two lines give sone variety to the direction 

252 REM Player 0 takes when Player 0 lines up with Player 1* 

254 REM 

260 REM xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

262 IF XDIR=0 THEN X ( 0 > =X < 0 > +1-INT < 3XRND < 0 > > 

264 IF YDIR=0 THEN Y< 0 >=Y< 0 > +1-INT < 3xRND < 0 ) > 

266 REM xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

268 REM 

270 REM If no collision between players* then continue Movewent. 

272 REM 

280 REM xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

282 IF NOT PEEK (53260) THEN 212 

2| ^\ E*j 5(C )IC 5IC JIC 5IC 5K 5IC }K 5IC 5IC 5IC 5IC )IC 5IC )K 5(C )K 54C 5IC 5IC 5tC 5IC )(C 5IC 5IC 5(C 5K 5IC 5(C 5IC JIC 5K 5(C JtC 5IC 5IC 5IC 5iC 5IC )IC 5iC 5IC JIC )IC 5(C 5(C 3(C 3iC )IC 

286 REM 

290 REM A collision occurred so the color of Player 0 

292 REM is changed in the following lines* 

294 REM 

30 0 REM xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

302 FOR C0L0R=198 TO 207 

304 POKE 704, COLOR 

306 FOR PAUSE=1 TO 20 J NEXT PAUSE 

308 NEXT COLOR 

310 FOR COLOR=207 TO 63 STEP -16 

312 POKE 704, COLOR 

314 FOR PAUSE=1 TO 20:NEXT PAUSE 

316 NEXT COLOR 

318 FOR C0L0R=63 TO 50 STEP -1 

320 POKE 704, COLOR 

322 FOR PAUSE=1 TO 20 : NEXT PAUSE 

324 NEXT COLOR 

\3 f \ fili ^tC ^fC ^JC 5tC ^iC 

328 REM 

330 PRINT t PRINT "Watch again "JtlNPUT ANS* 

332 POSITION 2, I! PRINT " 

334 IF ANS*="Y" THEN 142 

340 REM 

342 REM Move players off the screen before ending prograM. 

344 REM 

^jj Q J™^ 5IC 3(C 5(C 5IC 5IC )K 5(C 5IC )IC 5(C 5IC 5IC 5fC )IC 5(C 5(C 5IC )IC )(C 5(C 5IC 5IC 5IC 5IC 5IC )tC 3(C JiC 5(C )K JIC 5IC 5(C 5IC 5iC 5IC 3(C 5iC )IC 5IC )(C 5(C )IC 5iC 5(C 5(C 5IC 5tC 5IC 5IC 3(C 3iC 

352 POKE 53248, OtPOKE 53249,0* GRAPHICS 01END 



There are some special memory locations that enable users to more fully utilize 
Player-Missile Graphics* You may wish to experiment with some of the following 
locations* 



Each player has its own color which can be changed by POKING the appropriate 
location with a value equal to 16*HUE+LUMINANCE. Thus f to give Player 1 a hue of 2 
and a luminance of 4, use the BASIC statement POKE 705, 36* 



7(H 
705 
706 
707 



Color of Player ()♦ 

Color of Player 1* 

Color of Player 2* 

Color of Player 3* 



Each player can be normal width, double width, or quadruple width* POKE the 
appropriate location listed below with a 0, 1, or 3 respectively to get these three 
different widths. Thus, to make Player 2 quadruple width, use the statement POKE 
53258, 3* 



53256 
53257 
53258 
53259 



Width of Player 0* 
Width of Player 1« 
Width of Player 2* 
Width of Player 3* 



Each player has a memory location which tells the computer where to place the player 
along the horizontal axis (left to right). Each location can be POKED with a number 
from 0 to 255 where a 47 would put the player at the left edge of the screen and a 208 
would put it at the right edge* There is no need to deal with these position registers 
if you use the subroutine generated by PLAYER MAKER to put your players on the 
screen. The subroutine uses the variable XSPOT to change your player's horizontal 
position. 



53248 
53249 
53250 
53251 



Horizontal position of Player 0* 

Horizontal position of Player 1« 

Horizontal position of Player 2* 

Horizontal position of Player 3* 
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There are a number of registers used to detect a collision on the screen* that is» if a 
player touched another player or touched an object drawn on the screen* Any of the 
following locations can be checked in BASIC by seeing if PEEK (location) O <)♦ If this 
comparison is true, then a collision occurred* These collision registers cannot be 
reset to zero by POKING a zero to them* Rather* you reset them all with the one 
statement? POKE 53278* 0* 



53252 


Player 


0 


to 


Playfield collisions* 


53253 


Player 


1 


to 


Playfield collisions* 


53254 


Player 


2 


to 


Playfield collisions. 


53255 


Player 


3 


to 


Playfield collisions* 


53260 


Player 


0 


to 


Player collisions* 


53261 


Player 


1 


to 


Player collisions. 


53262 


Player 


2 


to 


Player collisions* 


53263 


Player 


3 


to 


Player collisions* 
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